home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / comm / cnet / INetShell307.lha / INetShell / INetShell.doc < prev    next >
Text File  |  1996-12-18  |  48KB  |  1,130 lines

  1. /*****************************************************************************\
  2. |*****************************************************************************|
  3. |*****************************************************************************|
  4. |***                                                                       ***|
  5. |***   INet-Shell:  A utility to offer a simple-to-use interface between   ***|
  6. |***               AmiTCP/IP and CNet Pro v3.xx                            ***|
  7. |***                                                                       ***|
  8. |***   INet        v3.07  12/17/96 (AREXX - compiled)                      ***|
  9. |*** # INetConfig  v3.03  03/27/96 (SAS/C - v6.56)                         ***|
  10. |*** # INetMaint   v3.12  03/27/96 (SAS/C - v6.56)                         ***|
  11. |***                                                                       ***|
  12. |***        # - NOT YET UPDATED FOR USE WITH CNET VERSION 4.XX             ***|
  13. |***                                                                       ***|
  14. |***   RELEASE DATE:  12/17/96                                             ***|
  15. |***                                                                       ***|
  16. |***   Original concept and programming performed by:                      ***|
  17. |***                                                                       ***|
  18. |***                        Paul Leclair (Limahl)                          ***|
  19. |***                        limahl@ime.net                                 ***|
  20. |***                                                                       ***|
  21. |***   Continued support and updates, and conversion to CNet/C by:         ***|
  22. |***                                                                       ***|
  23. |***                        Andy Dickison (Seahorse)                       ***|
  24. |***                        seahorse@dcroads.com                           ***|
  25. |***                        seahorse@1:270/617.0                           ***|
  26. |***                                                                       ***|
  27. |***   Information, updated, technical support can be obtained at:         ***|
  28. |***                                                                       ***|
  29. |***                        Digital Crossroads BBS                         ***|
  30. |***                                                                       ***|
  31. |***               (717)843-7465 - 5 lines USR v.everthing 33.6K           ***|
  32. |***                     TELNET/FTP/WWW @  dcroads.com                     ***|
  33. |***                              204.186.35.16                            ***|
  34. |***                                                                       ***|
  35. |***                                                                       ***|
  36. |*****************************************************************************|
  37. |*****************************************************************************|
  38. \*****************************************************************************/
  39.  
  40. A special thanks to Paul Leclair for allowing me to continue his fine work on
  41. this program.  And his continued support with new ideas.
  42.  
  43. If you have any comments, please E-Mail them to me at:
  44.     seahorse@dcroads.com
  45.     dcroads@mail.ptdprolog.net
  46.  
  47. Also thanks go to the beta-testers:
  48.  
  49.     (none currently being used)
  50.  
  51.  
  52. /*****************************************************************************\
  53. |*                    NOTES ABOUT CONTINUEING DEVELOPEMENT                   *|
  54. \*****************************************************************************/
  55. INetShell 3.xx is currently being rewritten in C.  The Arexx source was
  56. released some time ago and the conversion process has begun.
  57.  
  58. Currently, the only programs available are INetConfig and INetMaint.
  59.  
  60. INetConfig is not completed, but is required and has all of the pervious config
  61. entries available.  The new INetConfig is needed to configure the new flags for
  62. INetMaint.
  63.  
  64. INetMaint is basically completed.  There may be some enhancements made in a
  65. future release, but it's VERY functional as it stands.
  66.  
  67. No completion date has been set as it's a bit early to date this project
  68. completion.  So, please do not send me a ton of email asking me when will it be
  69. done.  ;-)   I will keep you all posted.
  70.  
  71.  
  72. /*****************************************************************************\
  73. |*                              ABOUT INET-SHELL                             *|
  74. \*****************************************************************************/
  75. Originally conceived by Paul Leclair (Limahl) and support continued by Andy
  76. Dickison, INet-Shell, is one of the view interfaces available for CNet Amiga
  77. Pro 3.xx that provides and easy to use interface between CNet BBS and
  78. AmiTCP/IP, therefore allowing your users to fully access the growing services
  79. on the Internet with relative ease.
  80.  
  81. INet      : Is the heart and soul to INet-Shell, it is the actual interface
  82.             that your users will use for accessing the internet.  Presently
  83.             written and compiled in ARexx.  It is being rewritten as a CNet/C
  84.             PFile with SAS/C v6.56 its release date at this time, is unknown.
  85.  
  86. INetMaint : "INetMaint" is a CNet/C utility that performs serveral vital
  87.             maintenance items associated with INet-Shell.
  88.             - Purges old INet directories from users how have been deleted
  89.               from your system and still have an INet FTP directory setup.
  90.             - Removes the users entry from the db/passwd file.
  91.             - Can purge files older than a set date from each users FTP
  92.               direcotory.
  93.             - Can provide a log to any or all of three different locations:
  94.               sysops mailbox, call log, and/or the maintenance log.
  95.             Written as a CNet/C PFile with SAS/C v6.56.
  96.  
  97. INetConfig: This is the program that you will use to configure the necessary
  98.             options to allow both INet and INetMaint to run properly and to
  99.             your desires.  Written as a CNet/C PFile with SAS/C v6.56.
  100.  
  101.  
  102. /*****************************************************************************\
  103. |*                                LEGAL STUFF                                *|
  104. \*****************************************************************************/
  105.  
  106. COPYRIGHT INFORMATION:
  107.  
  108. The program, INetShell and its associated files are written and copywrited
  109. by Andy Dickison (CND Communications).  INetShell is SHAREWARE and the
  110. UNREGISTERED version may be freely distributed providing the following
  111. conditions hold:
  112.  
  113. o Distributors may not charge more than the cost of a diskette used in the
  114.   distribution of this program.
  115.  
  116. o Distributors may only distribute the unmodified copy of the original
  117.   program, along with all of its documentation, and copywrite notices
  118.   intact.
  119.  
  120. o Commercial distribution is only possible with written permission from the
  121.   author.
  122.  
  123.  
  124. LICENSE AGREEMENT:
  125.  
  126. The REGISTERED versions of INetShell may not be redistributed.
  127. Redistribution is illegal, immoral, and strictly prohibited.  The licensed
  128. keyfile is good for only a single copy of CNet Amiga (c)ZenMetal.
  129.  
  130.  
  131. DISCLAIMER:
  132.  
  133. This   program  and  its  documentation  are  provided  "as  is".   No
  134. warranties  are  made  with  respect  to  the  accuracy,  reliability,
  135. performance  or  operation  of this software and information.  You are
  136. using this program at your own risk.  The author is not liable for any
  137. damages that may have been caused by using this software.
  138.  
  139.  
  140. /*****************************************************************************\
  141. |*                                INSTALLATION                               *|
  142. \*****************************************************************************/
  143. This will explain how to install the INetShell.
  144.  
  145.  
  146. -------------------------------------------------------------------------------
  147. o   Unarchive the INet Shell archive to an empty directory (lha -a x).
  148.  
  149. -------------------------------------------------------------------------------
  150. o   Create a directory in SysData: called DCROADS.  Place the keyfile that you
  151.     have obtained from me in SysData:DCROADS/.  Failure to do so, will prevent
  152.     proper opertion of INetShell.
  153.  
  154. -------------------------------------------------------------------------------
  155.  
  156. o   Verify that the pure bits on the executables INET, INETMAINT, and
  157.     INETCONFIG are set, as all three programs CAN be made resident and are
  158.     compiled pure.
  159.  
  160. -------------------------------------------------------------------------------
  161. o   Make a directory in PFILES: called "INetShell"
  162.  
  163. -------------------------------------------------------------------------------
  164. o   Copy the contents of the archive into Pfiles:InetShell/
  165.     (For those of you upgrading from a previous version, ensure that ALL
  166.     of the contents of of the config file are present or you WILL run into
  167.     problems).
  168.  
  169. -------------------------------------------------------------------------------
  170. o   Be sure that the "PURE" bit (p) is set on the INet main binary.
  171.     (ie. protect INet +p)
  172.  
  173. -------------------------------------------------------------------------------
  174. o   In your INetShell/config directory, you will find 2 files "INet1.305c"
  175.     and "INet.4xx" rename the file that is associated with the version of
  176.     CNet that you are running on your system to INet1.
  177.  
  178. -------------------------------------------------------------------------------
  179. o   The main INet-Shell binarys may be made resident to save memory.  The
  180.     format is:
  181.  
  182.     "resident PFiles:INetShell/INet       PFiles:INetShell/INet       pure add"
  183.     "resident PFiles:INetShell/INetConfig PFiles:INetShell/INetConfig pure add"
  184.     "resident PFiles:INetShell/INetMaint  PFiles:INetShell/INetMaint  pure add"
  185.  
  186. -------------------------------------------------------------------------------
  187. o   Move the files RPSTART and RPHI in the c/ directory over to C:
  188.         (do this only if you do not already have them on your system)
  189.  
  190. -------------------------------------------------------------------------------
  191. o   Move the rexxplslib.library in libs/ over to Libs:
  192.         (do this only if you do not have this library already)
  193.  
  194. -------------------------------------------------------------------------------
  195. o   (Do the following only if you haven't installed Rexx Plus on your machine):
  196.         o   Edit your S:user-startup
  197.         o   Add a line with the command RPSTART >NIL:
  198.  
  199. -------------------------------------------------------------------------------
  200. o   If you are updating from any version OLDER than 2.4 then you MUST delete
  201.     Mail:users/#?/.netrc
  202.  
  203. -------------------------------------------------------------------------------
  204. o   If you have been running another kind of interface program or have had
  205.     users using FTP and have previously set up the .netrc file(s), they must
  206.     be all deleted.  Usually, they will reside in "Mail:users/<dir>".  You
  207.     can delete them all by doing the following command:
  208.  
  209.         Delete Mail:users/#?/.netrc
  210.  
  211. -------------------------------------------------------------------------------
  212. o   Edit your CNet:BBSMENU file(s) and add the following command to section
  213.     "1; Maintenance menu":
  214.  
  215.         INETCONFIG      |{#2 PFiles:INetShell/INetConfig}
  216.         INETMAINT       |{#2 PFiles:INetShell/INetMaint}
  217.                          ^
  218.                      Control-Q
  219.  
  220. -------------------------------------------------------------------------------
  221. o   Save bbsmenu file(s) and reload your BBSTEXT/MENU files from the
  222.     CNet Control panel.
  223.  
  224. -------------------------------------------------------------------------------
  225. o   Run INETCONFIG and setup all of the program defaults/settings.
  226.  
  227. -------------------------------------------------------------------------------
  228. o   Edit your cnet:bbsmenu file(s) and add the following command to section
  229.     to section "3; Main Prompt"
  230.  
  231.         NET             |{#0 PFILES:INetShell/INet}
  232.                          ^
  233.                      Control-Q
  234.  
  235. -------------------------------------------------------------------------------
  236. o   Save bbsmenu file(s) and reload your BBSTEXT/MENU files from the
  237.     CNet Control panel.
  238.  
  239. -------------------------------------------------------------------------------
  240. o   Set up a directory to store the user's profiles & ftp files (this directory 
  241.     must match the name used in INETCONFIG for the users FTP direcotry).
  242.     (ie. MAKEDIR <dirname>)
  243.  
  244.     Suggestion:  use a drive that has a lot of storage because
  245.                  this is where all FTP files end up when a user
  246.                  does an FTP.
  247.  
  248.                  It is HIGHLY suggested that you do NOT set up
  249.                  the directory to merge with "mail:users/" due
  250.                  to users having the ability to download and/or
  251.                  upload to this directory area.
  252.  
  253. -------------------------------------------------------------------------------
  254. o   "NET" should now be configured and ready to go. 
  255.  
  256.  
  257. /*****************************************************************************\
  258. |*            NOTES CONCERNING INSTALLATION / COMMON PROBLEMS                *|
  259. \*****************************************************************************/
  260.  
  261. -------------------------------------------------------------------------------
  262.  
  263. PROBLEM : Running FTP/ncftp gurus my computer
  264.  
  265. SOLUTION: For proper operation of INetShell FTP Feature, you need to run
  266.           cnet with a stack of atleast 40000 at this time.
  267.  
  268. -------------------------------------------------------------------------------
  269.  
  270. PROBLEM : My system freezes after just after I start INetShell, or after
  271.           the statement "PLEASE ASK YOUR SYSOP TO REGISTER INET-SHELL"
  272.           for Unregisted versions of INetShell.
  273.  
  274. SOLUTION: AmiTCP/IP users:  Make sure that you have INET:  assigned to
  275.           AmiTCP:
  276.  
  277.           Miami Users:  See problem below for your solution.
  278.  
  279. -------------------------------------------------------------------------------
  280.  
  281. PROBLEM : I am running Miami as my TCP/IP stack and INetShell freezes just
  282.           after startup.
  283.  
  284. SOLUTION: Miami Users:  INetShell has been shown that it will run under Miami,
  285.           however, as INetShell was developed around AmiTCP you will need to do the
  286.           following:
  287.  
  288.           o Assign INET: to Miami:
  289.  
  290.           o Assign AmiTCP: to Miami:
  291.  
  292.           o Create a directory in Miami: called bin
  293.  
  294.           o Place all clients used by INetShell in Miami:bin
  295.             (ncftp, telnet, talkclient, amyirc, lynx, bbgopher, finger, etc)
  296.  
  297.           o Last but not least you need to obtain a copy of the AmiTCP program
  298.             AmiTCP:bin/hostname and place it into miami:bin
  299.  
  300. -------------------------------------------------------------------------------
  301.  
  302. PROBLEM : Running amyirc either gurus my system or will not work at all.
  303.  
  304. SOLUTION: To get amyirc running correctly the following needs to be done:
  305.  
  306.           o Rename the amyirc program to aamyirc
  307.  
  308.           o Create a script file (S protection flag set) called "amyirc" with the
  309.             following in it.
  310.  
  311.       ---------------- START: CUT HERE ----------------
  312. .KEY ONE,TWO,THREE,FOUR,FIVE,SIX,SEVEN,EIGHT
  313. changetaskpri -1
  314. inet:bin/aamyirc <ONE> <TWO> <THREE> <FOUR> <FIVE> <SIX> <SEVEN> <EIGHT>
  315. changetaskpri 0
  316.       ---------------- END  : CUT HERE ----------------
  317.  
  318.           o Create a file in sys:env or sys:prefs/env-archive (depending on verion
  319.             of amigados) called "socketconfig" with the follwoing information:
  320.  
  321.       ---------------- START: CUT HERE ----------------
  322. UID=200 GID=200 USER=dcroads DOMAIN=com UMASK=002
  323.       ---------------- END  : CUT HERE ----------------
  324.  
  325.             change the "user" to the first part of you domain name and domain to
  326.             the last. (ie com, org, net, etc).
  327.  
  328. -------------------------------------------------------------------------------
  329.  
  330. PROBLEM : Lynx will not run on my system
  331.  
  332. SOLUTION: To get lynx running use the following script file "alynx"
  333.  
  334.       ---------------- START: CUT HERE ----------------
  335. ;Script for ALynx & INetShell
  336. ;written fully by Dave Anderson of Ground Zero Communications (gzero.com)
  337. echo "Loading...."
  338. cd > T:ll
  339. rx amitcp:bin/name
  340. delete t:ll quiet
  341. execute t:ldir
  342. delete t:ldir quiet
  343. execute t:hdir
  344. delete t:hdir quiet
  345. wait 1
  346. amitcp:bin/alynx.exe http://localhost -show_cursor -rlogin -telnet -noprint
  347.       ---------------- END  : CUT HERE ----------------
  348.  
  349. -------------------------------------------------------------------------------
  350.  
  351. PROBLEM : BBGopher is unreliable and does not work well.
  352.  
  353. SOLUTION: As I have found bbgopher unrealialbe at this time, I use lynx for
  354.           gopher as well.  To do this:
  355.  
  356.           o Rename bbgopher to something you will not use.
  357.  
  358.           o Create a script file "bbgopher" with S protection bit set, with the
  359.             following contents:
  360.  
  361.       ---------------- START: CUT HERE ----------------
  362. ;Script for ALynx & INetShell
  363. ;written fully by Dave Anderson of Ground Zero Communications (gzero.com)
  364. echo "Loading...."
  365. cd > T:ll
  366. rx amitcp:bin/name
  367. delete t:ll quiet
  368. execute t:ldir
  369. delete t:ldir quiet
  370. execute t:hdir
  371. delete t:hdir quiet
  372. wait 1
  373. amitcp:bin/alynx.exe http://gopher.micro.umn.edu -show_cursor -rlogin -telnet -noprint
  374.       ---------------- END  : CUT HERE ----------------
  375.  
  376. -------------------------------------------------------------------------------
  377.  
  378. This should take care of most peoples problems with getting INetShell
  379. operational.  Please contact me if you have any additional questions.
  380.  
  381. -------------------------------------------------------------------------------
  382.  
  383.  
  384. /*****************************************************************************\
  385. |*            EDITING AND CONFIGURING INET-SHELLS OTHER DATA FILES           *|
  386. \*****************************************************************************/
  387. There are 7 types of config files that the shell uses.  The files are located
  388. in PFiles:INetShell/Config/
  389.  
  390.  TelnetMenu  -  main list of telnet sites (menu)
  391.     Telnet#  -  actual telnet sites
  392.     FTPMenu  -  main list of ftp sites (menu)
  393.        FTP#  -  actual ftp sites
  394.  ArchieServ  -  list of Archie servers
  395.   IRCServer  -  list of IRC servers
  396.  
  397. -------------------------------------------------------------------------------
  398. TelnetMenu:
  399.  
  400. TelnetMenu is the primary menu that users see when they first enter the Telnet
  401. command off the main menu of INetShell.  This is just a list of available
  402. sub-menus that the user can enter.  There is no limit to how many sub-menus
  403. you can create.
  404.  
  405. The format of TelnetMenu is:
  406.  
  407. 2
  408. Menu Item 1
  409. Menu Item 2
  410.  
  411. Line1: the total amount of entries in the file (excluding line 1)
  412. Line2: name of directory
  413. Line3: name of directory
  414. etc
  415.  
  416.  See the example that is packaged with INetShell.
  417.  
  418. -------------------------------------------------------------------------------
  419. FTPMenu:
  420.  
  421. FTPMenu is the primary menu that users see when they first enter the FTP
  422. command off the main menu of INetShell.  The data format is the same as
  423. TelnetMenu.
  424.  
  425. -------------------------------------------------------------------------------
  426. IRCServer:
  427.  
  428. This is a list of IRC Servers that you can reach.  The data file format is set
  429. up like so:
  430.  
  431. 1
  432. IRC Server (US)
  433. irc.pitt.edu
  434.  
  435.  
  436. Line1: number of total servers listed
  437. Line2: Name given for the server (the name that will show up on the
  438.        server listing)
  439. Line3: the actual server domain name or IP#.
  440.  
  441.   See the example IRCServer file in the config directory.
  442.   As with TelnetMenu and FTPMenu, there is no limit to how many
  443.   servers you may add to this list.
  444.  
  445. -------------------------------------------------------------------------------
  446. ArchieServ:
  447.  
  448. This file contains the available Archie servers that your users can use when
  449. doing an Archie file search.
  450.  
  451. The format is:
  452.  
  453. site.name.or.ip
  454. site.name.or.ip
  455. site.name.or.ip
  456. etc
  457. etc
  458.  
  459. There is a maximum of 8 sites you can have listed.  This may change in the
  460. future if there is a need for a larger list.  Note that this file format does
  461. NOT contain the # of sites at the start.  It only contains the domain or IP# of
  462. the Archie server site.
  463.  
  464. -------------------------------------------------------------------------------
  465. Telnet#:
  466.  
  467. The Telnet(number) file(s) contain the actual sites and descriptions of the
  468. Telnet sites.  These files are connected with the TelnetMenu file.
  469.  
  470. Here is how it works:
  471.  
  472.   If in TelnetMenu, you have 3 entries, you must have 3 Telnet# files
  473.   (Telnet1, Telnet2 & Telnet3).  When the user picks item 1 off the
  474.   main Telnet list, it will load up and display the Telnet1 sub-menu.
  475.  
  476. The format is:
  477.  
  478. 1
  479. The Kobayashi Alternative BBS
  480. tka.com 23
  481. This is a CNet BBS and home of
  482. the INetShell interface program.
  483.  
  484. Line0: Total number of sites in list
  485. Line1: Name of the Telnet Site
  486. Line2: the domain.name or IP# and (optional) port number
  487. Line3: description line 1
  488. Line4: description line 2
  489. Line1:
  490. Line2:
  491. LIne3:
  492. Line4:
  493.  
  494. Please note, if you use the TELNET client that comes with the the INet package,
  495. passing a parameter "-m1" before the site name will cause Telnet to go into
  496. "mud mode" which is basically an echo character mode.
  497.  
  498. Note, you MUST have 2 description lines before the next entry.  These can be
  499. blank lines if you wish not to have any description listed.  There is no limit
  500. to how many sites you can have listed in these files.
  501.  
  502. -------------------------------------------------------------------------------
  503. FTP#:
  504.  
  505. The FTP(number) file(s) contain the actual sites and descriptions of the FTP
  506. sites.  These files are connected with the FTPMenu file.
  507.  
  508. The format and how it works is the same as the Telnet# files.
  509.  
  510. -------------------------------------------------------------------------------
  511.  
  512.  
  513. ===============================================================================
  514. WHAT IT DOES:
  515.  
  516. What happens when a new user gets into the INetShell:
  517.  
  518.  1. The program will check to be sure that they have a valid Internet Name
  519.     (UUCP ID).  If this has never been set, it will ask the user to enter a
  520.     name or auto-set the ID depending on what config variable the sysop has
  521.     chosen for this.
  522.  
  523.  2. The program will then create the user's FTP storage directory in the
  524.     location you specified in the "INet" config file. 
  525.  
  526.  3. It will then copy the default "." files from the INetShell/new/ directory
  527.     into their FTP storage directory.
  528.  
  529.  4. It will then create a .netrc with default settings in the user's
  530.     "mail:users/<dir>" area.
  531.  
  532.  5. Then it will maintain the AmiTCP:db/passwd file (as specified in the INet
  533.     config) and add an entry for their account.
  534.  
  535.  6. Finally it will let them into the main menu.
  536.  
  537.  
  538. ===============================================================================
  539. ACCOUNTING & UNLIMITED TIME FEATURE:
  540.  
  541. INet has the ability to give a user unlimited time while they are in the shell
  542. program itself without disturbing the user's daily allowed time per day.  This
  543. flag can be set in INetConfig.
  544.  
  545. Also, INet can calculate a balance total for usage within the shell itself.
  546. This was set up for those sysops who use the CNet Accounting system to keep
  547. track of different areas of their system.  In this case, INet will calculate
  548. the amount of time by the amount to charge (see INetConfig's entry for
  549. Accounting costs) and then subtract that from the balance on the user's account
  550. when they exit INetShell (or drop carrier - whichever comes first).
  551.  
  552. ===============================================================================
  553. SHELL FEATURE (V2.5+)
  554.  
  555. In version 2.5 and up, a SHELL/Expert Mode option has been made for users who
  556. are familiar enough with Telnet/FTP and such to use command line prompting
  557. rather than the menu system.  
  558.  
  559. As a bonus to this shell mode are the clients "ASKHOST", "RESOLVE", and
  560. "TRACEROUTE".  These utility clients must be in your AmiTCP:bin/  directory in
  561. order for them to work properly.
  562.  
  563. ===============================================================================
  564. NOTES ON THE TALK CLIENT FOR INETSHELL:
  565.  
  566. The newest addition to INetShell is the Talk client.  This client gives your
  567. users the ability to "talk" in a split-screen window with someone else on the
  568. the Internet.  It's similar to CC-Chat.  From the tests I've run on my system,
  569. it does support CTRL-C drops very well and has never crashed m board.  The
  570. The version we're running is 1.53 of AmiTALK (available on AmiNet).  
  571.  
  572. What I suggest is that you install AmiTALK according to the docs included with
  573. the archive and configure it so that the "TALK" command is available from any
  574. prompt.  I believe the instructions are included in the archive to have this
  575. work.  This is so that if a user on another system is requesting a "TALK"
  576. session with you, you will be able to start TALK up without having to go into
  577. INetShell to do it.
  578.  
  579. If you run into any problems with the Talk client, just rename it to something
  580. else.  This will disable the feature - when the client gets called.
  581.  
  582. ===============================================================================
  583. BUGS & ERROR REPORTS:
  584.  
  585. Should the program have a programming error (GOD FORBID!), it will report it in
  586. E-Mail to User ID#1 (usually the sysop).  Please forward this mail file to me
  587. at my Internet address (dcroads@postoffice.ptd.net).
  588.  
  589.   Note that the program may and will error out should you run the
  590.   ARexx "halt" (hi) command.  Usually, it will give some kind of
  591.   syntax error.  The next release (1.5) should have this taken care
  592.   of.
  593.  
  594.  
  595. /******************************************************************************\
  596. |*                             INET UPDATE HISTORY                            *|
  597. \******************************************************************************/
  598.  
  599.   PROGRAM NAME:  INet
  600.  
  601.   PURPOSE     :  To offer a simple-to-use interface between AmiTCP/IP
  602.                   and CNet BBS users.
  603.  
  604.   RELEASED    :  12/17/96
  605.  
  606.   VERSION     :  3.07
  607.  
  608. -------------------------------------------------------------------------------
  609.  
  610.   REVISIONS   :
  611.  
  612.   3.07  (12/17/96)  - Formats INetShell usage log so it is now easier to read.
  613.                     - INet1 executables now contain version strings, by using
  614.                       version full INet1(.xxx) it is easy to tell which version
  615.                       of CNet this is for.
  616.                     - Some users still having problems with INetShell not
  617.                       recognizing a valid registered copy.  Have made some
  618.                       some changes to code, in hopes that this will fix the
  619.                       problem.  INet-Shell works fine on my system(s) for both
  620.                       CNet 3.05c and CNet 4.24d.
  621.                     - Updated INet1 for version 4.24d of CNet.
  622.                     - Created subdirectories RAM:INetShell/Config and
  623.                       RAM:INetShell/Text for preperation of C version.
  624.  
  625.   3.06  (09/03/96)  - Found a problem with CNet not properly updateing the
  626.                       UUCP ID pointers in memory, after being changed either
  627.                       manually or automatically via INetShell under CNet v4.xx.
  628.                       This problem with INetShell has been fixed.
  629.                     - Recompiled INet1.421 for use with CNet Amiga version
  630.                       4.21 Beta.
  631.                     - Problem reported with one version of animated more prompt
  632.                       preventing proper keyfile checking.  Added a command to
  633.                       disable more prompt first thing in program execution.
  634.                       This should fix this problem/bug.
  635.                     - Fixed MOTD title screen to properly indicate (and give
  636.                       credit) to previous and present author of INetShell.
  637.  
  638.   3.05  (06/28/96)  - Created a "Demo" mode.  This will allow perspective
  639.                       INetShell users to see what it will do for them.  In the
  640.                       "demo mode" only one user online will be able to use
  641.                       INetShell at a time.
  642.                     - Fixed/recompiled keyfile check program for use with v412d
  643.                       of CNet.
  644.  
  645.   3.04  (06/09/96)  - Found a problem with the generation of an automatic
  646.                       UUCPID.  Pre 3.03 versions of INetShell, use the users
  647.                       handle to generate a UUCP id if the sysop has elected to
  648.                       not let a user select their own.  As CNet uses the first
  649.                       letter of the first name and upto 7 letters of a users
  650.                       last name to automatically generate the UUCPID during
  651.                       the first time they logon (v4.11+ of CNet), I have fixed
  652.                       INet shell to do the same.  With the added feature that
  653.                       it will generate up to 9999 new UUCPID for duplicate
  654.                       original UUCPID numbers.
  655.  
  656.   3.03  (03/27/96)  - Wrote a fix that will make INet compatible with the way
  657.                       Ken had his hex format of Mail:users/???? mailbox setup.
  658.                       This version should ONLY be used for v4.08 - v4.10 of
  659.                       CNet.  (Executable name INet.408_410)  
  660.  
  661.   3.02  (03/27/96)  - FULL INetShell program developement turned over to Andy
  662.                       Dickison.
  663.                     - Put in hostname checking for the purposes of VERIFING
  664.                       that AmiTCP/IP is in operation and allowing users to see
  665.                       what the domain name of the system is at this point in
  666.                       time (added for those few sysops that use INetShell and
  667.                       do not have a permanent INetNet site).
  668.                     - Added keyfile method of maintaining security of
  669.                       registered verisons of program.
  670.  
  671.   3.01  (09/01/95)  - Fixed screen clearing problem when returning from the
  672.                       archie server screen.
  673.                     - Removed hostname checking.
  674.  
  675.   3.00  (06/27/95)  - Well, it's my birthday today so I just HAD to release
  676.                       another update!  
  677.                     - Added the talk client w/new screen.
  678.                     - Fixed a carrier check bug that one of my users
  679.                       so nicely discovered.
  680.                     - Added host checking.  If the INetShell hostname
  681.                       doesn't match your system hostname, INetShell will
  682.                       abort - giving an error Hostname mismatch error.
  683.                     - Rewrote the documentation in an AmigaGuide format.
  684.                     - Fixed a config file that was reading from disk
  685.                       even though the COPY-CONFIG-TO-RAM option was set.
  686.  
  687.   2.90  (04/23/95)  - Added LYNX to the main menu.
  688.                     - Added Gopher to the main menu.
  689.                     - Restructed the main menu a bit.
  690.                     - Cleaned up a clear screen code that was bugging me.
  691.                     - Fixed a minor bug with the way the options were being
  692.                       chosen from the FTP/Telnet menus.
  693.                     - Included are the archives for ALynx and BBGopher.
  694.  
  695.   2.80  (04/13/95)  - Added usage logging (configurable via INetConfig)
  696.                       (logs users who ran INetShell).
  697.                     - Added ability to prevent crashing on reading directories
  698.                       within the user's INetShell FTP storage dir.
  699.  
  700.   2.70  (03/23/95)  - Bug fix:  At the telnet prompt checking for redirection,
  701.                       I never bothered to check for the -m1 option for MUD
  702.                       mode.  It should work fine now (HOPEFULLY).
  703.                     - Also reworked some of the screens to give them a bit more
  704.                       of that 3D look and feel.  In the future, when CNet
  705.                       supports RIP, it will have functional buttons.
  706.  
  707.   2.60  (03/20/95)  - Bug fix:  at all prompts, users were able to redirect
  708.                       output of the client software to any file on your disk
  709.                       (including your sysdata: files if they know CNet and its
  710.                       data files.  This has been fixed.
  711.  
  712.   2.5b  (03/09/95)  - A bug was reported with the DS! routine in Dir-Maint so I
  713.                       put a delay before it returns to the program after the
  714.                       file(s) have been transfered.
  715.                     - Had to change the DS! back to DS and put a carrier check
  716.                       that will hopefully solve the bug with logoff after
  717.                       completion.  if this doesn't do it, then I'll have to
  718.                       make DS a sysop configurable option.              
  719.  
  720.   2.5a  (02/26/95)  - Changed IRC routine where it would show the user's real
  721.                       name to their UUCP ID.
  722.                     - Changed the download selected files in Dir-Maint to not
  723.                       allow options like auto-logoff.
  724.  
  725.   2.50  (02/22/95)  - Added a SHELL mode for expert users.
  726.  
  727.   2.4a  (02/15/95)  - Fixed addressing of finger from just "finger" to
  728.                       "amitcp:bin/finger"
  729.  
  730.   2.40  (02/07/95)  - Did more work for the unlimited time options to fix
  731.                       another bug that I overlooked.
  732.                     - Changed the prompt for ncftp to display system time
  733.                     - Added mprompt feature for mget prompting in config and
  734.                       .netrc (must delete ALL old .netrc's)
  735.  
  736.   2.30  (02/01/95)  - Fixed some nasty errors in the accounting calculations
  737.                       which resulted in subracting more time than it should
  738.                       have been (thanks to jrobbins@proton.com for finding
  739.                       this).
  740.                     - Cleaned up the display on accounting so that the decimal
  741.                       points line up.
  742.                     - Reworked the clock/timer routine a bit so that it works
  743.                       correctly in minutes and % of minutes (like how CNet
  744.                       displays # of minutes used).
  745.                     - Checked to be sure that the .netrc gets deleted should
  746.                       the user decide to change their UUCP ID via EP;12.
  747.  
  748.   2.20  (01/16/95)  - Added unlimited time for users in configurations.
  749.                     - Added options to copy all config files to ram.
  750.                     - Added sysop maint deactivates limit on FTP dir.
  751.                     - Added configurations for charging via CNet Accounting.
  752.  
  753.   2.1b  (01/06/95)  - Fixed bug for creating new users and not having the
  754.                       correct passwd file entry.
  755.  
  756.   2.1a  (01/01/95)  - Added DirMaint storage directory size limit configurable
  757.                       from INetConfig demo version created from 2.1a release.
  758.  
  759.  
  760.   2.00  (12/28/94)  - FINAL version - ready for release!
  761.                     - Debugging some more code.
  762.                     - Adding security checks (system hostname).
  763.   1.6e  (12/28/94)  - Fixed the aposthrophie bug in the notebook (yippee!).
  764.                     - Added 2 new screens (telnet/ftp) for manual dialing.
  765.  
  766.   1.6d  (12/27/94)  - Added Upload function (configured by INetConfig).
  767.                     - Fixed annoying bug in Edit routine (renaming files).
  768.  
  769.   1.6c  (12/25/94)  - Shortened subroutine names and compiled (pure bit set)
  770.                       for speed.
  771.  
  772.   1.6b  (12/23/94)  - Fixed some of the input strings to lock out the use of
  773.                       double quotes (").
  774.                     - Compiled with Rexx Plus for speed.
  775.  
  776.   1.6a  (12/22/94)  - Reworked the downloading routines to allow users to
  777.                       download just individual files without having to tag them
  778.                       first (saving a step)
  779.  
  780.   1.60  (12/22/94)  - Added a new sysop definable config in the INET config
  781.                       file to allow optional setting for creating new usesr
  782.                       accounts.
  783.                     - Added INET config entry to allow sysops to force a new
  784.                       user news file to be displayed when new users create an
  785.                       account.
  786.                     - Added INET config entry to set MOTD displaying before a
  787.                       user gets to the main menu.  (This is toggled on/off by
  788.                       the user in the Configurations menu.)
  789.  
  790.   1.50  (12/21/94)  - Added a few more checks for drop carriers.
  791.                     - Added a halt routine for sysop forced HI's.
  792.  
  793.   1.40  (12/19/94)  - Added a VIEW option in Directory Maintenance to view
  794.                       files.
  795.                     - Altered the dropcarrier routines so that they all check
  796.                       at the appropriate places.
  797.  
  798.   1.30  (12/18/94)  - Set up error logging to send email to CNet ID#1.
  799.  
  800.   1.20  (12/17/94)  - Added the "C" command in IRC to allow users to change
  801.                       handles without having to quit IRC mode.
  802.                     - Updated some of the display screens for a better 3D look.
  803.  
  804.   1.10  (12/16/94)  - Fixed a minor screen clearing routine that was happening
  805.                       twice for no reason.
  806.  
  807.   1.00  (12/15/94)  - Finished 1st version of program.
  808.  
  809.   0.00  (11/21/94)  - Initial creation of program.
  810.  
  811.  
  812. /******************************************************************************\
  813. |*                          INETCONFIG UPDATE HISTORY                         *|
  814. \******************************************************************************/
  815.  
  816.   PROGRAM NAME:  INetConfig
  817.  
  818.   PURPOSE     :  To allow editing of ALL the various configuration items
  819.                  associated with INetShell.
  820.                  - Basic configuration items.
  821.                $ - Permenant UUCP accounts in the AmiTCP passwd file.
  822.                $ - Telnet Sites.
  823.                $ - FTP Sites.
  824.  
  825.                           ($ - NOT YET IMPLEMENTED)
  826.  
  827.   RELEASED    :  03/27/96
  828.  
  829.   VERSION     :  3.03
  830.  
  831. -------------------------------------------------------------------------------
  832.  
  833.   REVISIONS:
  834.  
  835.   3.03  (03/27/96)  - Changed version number ONLY, to more easily keep track of
  836.                       which version series will work properly with the versions
  837.                       of CNet BBS.
  838.  
  839.   2.01  (09/12/95)  - Fixed a problem with the save routine/read config
  840.                       routine.
  841.  
  842.   2.00  (09/11/95)  - Rewritten in C.
  843.                     - Allows modification of FTP file age limit.
  844.                     - Allows modification of flag to delete old FTP files.
  845.                     - Gets BBS Name from CNet Configuration, and no longer
  846.                       allows sysop to edit it from INetConfig module.
  847.                     - Added version string.
  848.                     - Added flag to log INetMaint activity to call log.
  849.                     - Added flag to log INetMaint activity to maint log.
  850.                     - Added flag to log INetMaint activity to a specified
  851.                       users mail box.
  852.  
  853.   1.40  (04/13/95)  - Added usage log option #6.
  854.  
  855.   1.30  (01/16/95)  - Added copy to RAM: for config dir.
  856.                     - Added unlimited time option for INet.
  857.                     - Added accounting features.
  858.  
  859.   1.20  (01/01/95)  - Added DirMaint limit (Ftp storage dir).
  860.  
  861.   1.10  (12/30/94)  - Added INetMaint options (2nd screen).
  862.  
  863.   1.00  (12/25/94)  - Initial creation of program.
  864.  
  865.  
  866. /****************************************************************************\
  867. |*                          INETMAINT UPDATE HISTORY                        *|
  868. \****************************************************************************/
  869.  
  870.   PROGRAM NAME:  INetMaint
  871.  
  872.   PURPOSE     :  To delete old FTP directories from users who hoave been
  873.                  purged from the system.
  874.  
  875.                  To delete old FTP files (dated older than preset date)
  876.                  from the FTP directories of active users.
  877.  
  878.                  To maintain the PASSWD file used by AmiTCP, removing
  879.                  inactive UUCP entries, and duplicates.
  880.  
  881.   RELEASED    :  03/27/96
  882.  
  883.   VERSION     :  3.12
  884.  
  885.   NOTE: THIS VERSION WILL NOT WORK PROPERLY WITH CNET V4.08 - V4.10 AND I HAVE
  886.         NO INTENT OF PRODUCING A FIX FOR THESE VERSIONS OF CNET AS ANYONE THAT
  887.         IS STILL USING IT IS A FOOL.  :)
  888.  
  889. -------------------------------------------------------------------------------
  890.  
  891.   REVISIONS:
  892.  
  893.   3.12  (03/27/96)  - Version number change only, to correspond with the
  894.                       version of CNet that it is compatible.
  895.  
  896.   2.12  (09/23/95)  - Fixed problem with INetMaint tring to delete
  897.                       directories from within a users FTP Dir.
  898.  
  899.   2.11  (09/12/95)  - Updated structures to conform with those changed in
  900.                       INetConfig.
  901.  
  902.   2.10  (09/11/95)  - Added version string.
  903.                     - Rewrote file reading routines (should make passwd file
  904.                       maintenance routines faster).
  905.                     - Logs name of any "old" FTP files that are deleted during
  906.                       maintenance.
  907.                     - Added ability to log activities to the Call Log as 
  908.                       determined by INetConfig settings.
  909.                     - Added ability to log activities to the Maint log as
  910.                       determined by INetConfig settings.
  911.                     - Added ability to log activities to a specified users
  912.                       mail box.
  913.                     - Included a check to verify account message to be sent
  914.                       to, is still active, if not, mail will be sent to user
  915.                       # 1
  916.  
  917.   2.00  (09/03/95)  - Rewritten in C.
  918.                     - Added ability to delete old FTP files from user
  919.                       direcoties.
  920.                     - Added ability to update AmiTCP PASSWD file, both removing
  921.                       inactive entries, and duplicates.
  922.                     - Added a means to allow upto 100 for "permanant" PASSWD
  923.                       file entries.
  924.                     - Added a rudimentary progress report, by outputing maint
  925.                       actions to terminal screen.
  926.                     - Writes maintenance actions to the call log.
  927.  
  928.   0.00  (12/29/94)  - Start of program
  929.  
  930. /****************************************************************************\
  931. |*                      NOTES ABOUT v4.08 - v4.10 of CNet BBS               *|
  932. \****************************************************************************/
  933.  
  934. First off, why Ken changed the Mail:Users/????? directories to hex I haven't a
  935. clue.  But when he did this, he basically screwed INetShell.
  936.  
  937. In this archive, you will find 2 version of the INet Executable.
  938.  
  939.     INet         :  Usable for pre 4.08 and post 4.10 versions of CNet
  940.  
  941.     INet.408_410 :  Usable for ONLY v4.08 - v4.10 of CNet (Available at FTP
  942.                     site, left out of distribution for space considerations)
  943.  
  944. Additionally do NOT use the included version of INetMaint with v4.08 - v4.10
  945. of CNet, as it will totally screw up your users ftp directories by deleteing
  946. each and everyone of them.  I have no intent of releasing a version of
  947. INetMaint that will work under these versions of CNet as the problem nolonger
  948. exists under 4.11+, and any one that is still using v4.08-4v4.10 of CNet is
  949. asking for trouble.  ];-)
  950.  
  951. One other additional change must be made with your configuration files to make
  952. INetShell properly use Lynx under 4.08-4.10.
  953.  
  954. Useing you favorite text editor load in the Lynx script (and or bbsgopher script
  955. as I use lynx for both web and gopher browsing) make the folling change(s) so
  956. that the script looks like the following.
  957.  
  958. ----------------------------
  959.  
  960. ;Script for ALynx & INetShell
  961. ;written fully by Dave Anderson of Ground Zero Communications (gzero.com)
  962. echo "Loading...."
  963. ;cd > T:ll                <------------  NOTE THIS IS THE ONLY LINE TO CHANGE
  964. rx amitcp:bin/name
  965. delete t:ll quiet
  966. execute t:ldir
  967. delete t:ldir quiet
  968. execute t:hdir
  969. delete t:hdir quiet
  970. wait 1
  971. amitcp:bin/alynx.exe http://localhost -show_cursor -rlogin -telnet -noprint
  972.  
  973. ----------------------------
  974.  
  975. For use of lynx with gopher, I change the last line of this script to:
  976.  
  977. amitcp:bin/alynx.exe http://gopher.micro.umn.edu -show_cursor -rlogin ~
  978.                                                ~ -telnet -noprint
  979.  
  980. ----------------------------
  981.  
  982. This is all that I can think of at this point in time.  Contact me if you run
  983. into any additional problems.
  984.  
  985. Seahorse / Andy Dickison
  986. seahorse@dcroads.com
  987. dcroads@mail.ptdprolog.net
  988. seahorse@1:270/617.0
  989.  
  990.  
  991. /****************************************************************************\
  992. |*             UPGRADING INETSHELL FROM 3.01 OR EARLIER                     *|
  993. \****************************************************************************/
  994.  
  995. Make sure that you copy the INetShell/Config/INET1 program from the archive
  996. into pfiles:inetshell/config and ram:inetshell.  Or INetShell will not come
  997. up correctly.
  998.  
  999.  
  1000. /****************************************************************************\
  1001. |*                         HOW TO REGISTER INETSHELL                        *|
  1002. \****************************************************************************/
  1003.  
  1004.   To get a registered copy of INetShell, send $25.00 (US)
  1005.   
  1006.   (certified bank check or money order - no personal checks or cash)
  1007.   to:
  1008.  
  1009.                 CND Communications
  1010.                 PO Box 3579
  1011.                 York PA 17402-0579
  1012.                 
  1013.                 RE: INetShell
  1014.  
  1015.    Please make the check payable to:  CND Communications
  1016.   
  1017.    And please fill out and mail in the following form with your order:
  1018.  
  1019. ============================================================================
  1020.                  I N E T S H E L L   R E G I S T R A T I O N
  1021. ============================================================================
  1022.  
  1023.  
  1024.           REAL NAME:______________________________________________
  1025.  
  1026.  
  1027.  
  1028.      POSTAL ADDRESS:______________________________________________
  1029.  
  1030.  
  1031.  
  1032.                     ______________________________________________
  1033.  
  1034.  
  1035.  
  1036.                     ______________________________________________
  1037.  
  1038.  
  1039.  
  1040.              HANDLE:______________________________________________
  1041.  
  1042.  
  1043.  
  1044.            BBS NAME:______________________________________________
  1045.  
  1046.  
  1047.  
  1048.           BBS PHONE:______________________________________________
  1049.  
  1050.  
  1051.  
  1052.        FIDO ADDRESS:______________________________________________
  1053.  
  1054.  
  1055.  
  1056.  BBS DOMAIN NAME/IP:______________________________________________
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  SOFTWARE PACKAGE YOU ARE USING (choose one):
  1062.  
  1063.        [  ]   AmiTCP 3.0Beta2
  1064.  
  1065.        [  ]   AmiTCP 4.0 (beta)
  1066.  
  1067.        [  ]   AmiTCP 4.x (registered)
  1068.  
  1069.        [  ]   AS225
  1070.  
  1071.        [  ]   DNet
  1072.  
  1073.        [  ]   Miami
  1074.  
  1075.  
  1076.  HOW DO YOU WISH TO GET YOUR REGISTERED VERSION KEYFILE
  1077.         (ie. FTP'd, US-Snail Mail - choose one):
  1078.  
  1079.        [  ]  FTP : dcroads.com(204.186.35.16) FTP site
  1080.  
  1081.        [  ]  US-Mail (slower)
  1082.  
  1083.  
  1084.  
  1085.  OTHER COMMENTS:
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.   NOTES:  Upon completion of the C version there will be a $10
  1095.           upgrade fee.
  1096.  
  1097. =========================================================================
  1098.  
  1099.  
  1100. /****************************************************************************\
  1101. |*                         HOW TO CONTACT THE AUTHOR                        *|
  1102. \****************************************************************************/
  1103.  
  1104. I can be reached at:  (Please entitle you message INetShell for faster
  1105.                        response)
  1106.  
  1107.     seahorse@dcroads.com  (having problems with internic so this may not work)
  1108.     dcroads@mail.ptdprolog.net
  1109.     seahorse@1:270/617.0
  1110.  
  1111.  
  1112. WW/FTP/Telnet are all available at:
  1113.  
  1114.     dcroads.com    (having problems with internic so this may not work)
  1115.         or
  1116.     IP 204.186.35.16
  1117.  
  1118. /****************************************************************************\
  1119. |*                      KNOW BUGS WITH INETSHELL ITSELF                     *|
  1120. \****************************************************************************/
  1121.  
  1122. CNet 4.24d:   None Known
  1123.  
  1124. CNet 3.05c:   If you allow your users to change their UUCPID then the will be
  1125.               unable to read there mail until their next logon.  This is not
  1126.               a problem with INetShell, but a problem with CNet 3.05c (try
  1127.               editing your UUCPID via "ea" and then to read you mail).
  1128.  
  1129.  
  1130.